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1.0 INTRODUCTION 


1.0 INTRODUCTION 


Thus fars automated document generation here at CDD has 
been accomplished using low feveil commands whichs for the most 
parts only work on immediate and timited ovoortions of text, 
Few commands exercise significant contro! over large portions 
of text. As a results document preparation is hampered by the 
reiatively targe amount of work needed to orepare a text File 
for submission to a text formatter such as: TEXTJAB or TXTFORM. 
In TXTFORMs lines containing commands often outnumber lines of 
text. Thuss the input file to the formatter is hard to read 
and work one 


TXTCODE is designed to allow high tevelt formatting 
instructionss which correspond directiy to common. text 
structuress to be used to direct document generation. In this 
Ways commands of great power and range are abte to format a 
whole “text structure” usings in som? casess only an escape 
code and a worde . 


TXTCODE is designed so that the text heing input by the 
user will help to trigger in his mind the aoprooriate TXTCODE 
commands or format. The entered text also suqgests to the 
user the format of the original. Since retatively few codes 
are present the input file is normatly very readable. Thus 
on-line editing is simpler too = both visuatty and from an 
EDITing standpoint. TXTCODE*s input formats which is 
basicaliy free-form, ailtows tines and text strings to be 
freely replaceds added and deteted. 
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2-0 MODE OF OPERATION 
Philosophy 


The basic idea of TXTCODE is to have a command which 
corresponds to the text structure which is being inputs so 
that the formatter "knows" what it's trying to construct. 
Thus it will interpret the input in the context of what it is 
expecting and fit the input into the exnected patterns To 
keep things synchronizeds each input "mode" (context) has some 
simple conventions which trigger formatting actions at the 
correct time. These conventions consist of? 


e« blanks at the start of some ilines 
e trigger characters embedded in the text for’ some modes 


Definitions 


BLANK LINE? a tine which has no text data on it on input 
will normally generate one blank tine at that point in the 
text on output. 


COMMAND LINE? fines which start In position one with the 
master escape character (back slant \ by default» located to 
the right of the blue RETURN key on 713 terminals)» are 
assumed to be TXTCODE command lines. Such tines are used to 
give various kinds of instructions to the formatter. In some 
casess text is expected on the same line with the command. 


DATA LINE: any tine which is not a ®LANK LINE or a COMMAND 
LINE is interpreted as a DATA LINE. This type of line if 
processed by the currently active mode (ASTSs BLOCKs COMMENTs 
FLOWTABs ITEMs or TABLE) and is formatted into the 
corresponding text structure. 


NOTE: Under certain circumstancess any or all of the above 
types of lines may be ignored by the formatter. This happens 
in two cases: 1) a \STOP command has been Issued and a \GO has 
not been encountereds 2) a \TXTF command was given and a \VENDT 
has not yet been found. The STOP/GO takes precedence over the 
TXTF/ENDT command. 
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220 MODE OF OPERATIGN 


Processing 


The 6 mode commands and the section number commands are the 
heart of TXTCODE and with the occasional use of some of the 
other commands most text forms should be easify handled. 


Before describing the commands and modess an overview of 
TXTCODE*s approach will be given. 


At the highest ftevels, \STOP and \G9 have absolute control 
over the input files Al} input text following a \STOPs until 
a \G60 occurs will be utterly tgnored. Thus sections of the 
input file may be “turned-of Ff". 


The next level down is TXTF/ENDT. QInce ATXTF has been 
calleds ali input to TXTCODE (which reaches this level) is 
assumed to be for TXTFORM processing. 4e2ce8s the information 
is simply passed along to TXTFORM until a VENDT is encountered 
which returns control! to the current mode. YTXTFORM would onty 
be called though» if TXTCODE couldn't format a certain section 
of input text. With the addition of direct TXTFORM commandss 
there should be very few cases where \TXTF and \VENDT are 
actually needed. It should be used mainty to encapsulate 
existing TXTFORM input text. 


Going down another tlevel brings the input to TXTCODE 
proper. The input tine is first checked to see if it starts 
with the escape code (ususittly \) ands if sos the mode is 
aitered or some feature is set on/off etce [fF the line does 
not start with the escape codes it is orocessed by the mode 
which is currently operational (i.e. interoreted according to 
the present context) with consideration given to any "feature" 
which is active at that time. (@eGe JUSTEFication ON in 
TABLE mode has no effect). 


Normaliy a blank input tine is used to generate a blank 
output line. 


Input fine length is 80 characters of information. 
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3-0 SUMMARY OF COMMANDS 


All commands be entered in either lowercase or 


uppercaseés 


may 


Input File Control Commands 
\STOP 
\GO 
\TXTF 
\NENDT 
Mode Commands 


\ASTS 


\BLOCKsJnnsInnsHnn 
\COMMENT 
\FLOWTABxttstts.-.ttsff 
NITEMs Inns Inns Snnys GnnsHnnsZxxsC=e99 


2s 


\BLOCKsJ1 


VFLOWTAB 31520 
VITEMs,52 


ATABLExttstts...tt \TABLE3 105920» 30000 
Mode Nesting Commands 


\4L ee 2t] 
\-C e227]. 


\+0C.eet]mode command 
\-D.ee-]mode command 
\*mode command 
ANESTIND 

NEXTITNESTSC 
ACLEARNEST 


\NGNESTIND 


Designation Text Control 

ATITLEn=xxmKeoeX ATITLE=xxxxx e's 0% 
\DATE=xx Xe oeX 
NFOL ID=xxx 02% 
\TABLCON 
NAUTOSEC ANGAUTOSE?: 
Text Body Commands 

e Section numbers 


N NeNesaanelk KXXKKeae eX Vn XX one X or \ XX¥Xee2eXx 


\VSETSECAan 


or 


« Feature Selection De-selection 
\BOLD \NOBOLD 
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\CODES 

NHEADA VHEADB \VHEADC 

\JUST \NOJUST 

\KEEPn ANOKEEP 

\MARK. 

APARA VPARAnn \NOPARA 

\SEQ ANOSEQ 

\SINGLE ADOUBLE 

\UNDER \NOUNDER 

»« Text Format Control 

AMARGINaAN \MARGIN AMARGINenn \MARGIN=nn 

\VLENGTHnn ALENGTH ALENGTHtenn \LENGTH=<nn 

ASKIPnon 

\PAGE \PAGEnnn 

ACENTER=xxxe00exX VCENTER sBaUzxxx 202% 

\BLANKan 


9 Appendices 
ASETAPPsa-xxxes eX 
« Box Generation Commands 
\BOXx \BOXs T—InnsAsnnsBsl—Inns 2s f—INnN 
\MODBOXsC—-innsAsnnsBsl—-InnsRel-1n1 
\BOXLINE 
\NDBOX 
e Escape Character Definition 
\SETEx 
\SETUx 
\SETBx 
\SETHx 
Direct TXTFORM Commands 


\WWcommand 
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400 DESCRIPTION OF MODES 


One mode of the 6 (ASISs BLOCKs COMMENTs FLOWTABs ITEM,» or 
TABLE) is aiways active even if \ST92 or \TXTF has been 
called. When the \GO or VENDT is givens the mode resumes 
processing as if it had net been interruoted,. 


The initial mode is BLOCK. Transition to another mode is 
accomplished by simpity calling the desired mode with or 
without any mode parameters. Initially the left margin is set 
at 10» and the right margin to 62 positions to the right of 
the feft margin (i.e. LENGTH62),. 


Relevant features such as PARA or JUST are honored if they 
are applicable to the active mode. 


All of these modes process commands issued within the mode 
ands untless specified otherwises each node processes any 
active trigger characters for undertinings botdfacings and 
hard blanking. 


4o1 ASTS_MODE 
\ASIS 


Each data line encountered by the ASTS mode is copied as~is 
to output with no adjustment made to the fine structure. The 
lines start at the margin and will be truncated ff ftonger than 
62 characters (default fength). See the LENGTH command. A 
blank Jine produces a blank line on outout.: 


PARA and JUST have no effect on asris text. The 
underflinings boldfacing or hard-blank trigger characters are 
not recognized as trigger characters in ASIS modee However 
the \BOLD command may be used to botdface one or more whole 
lines of as~is text. 


Example: 

SOME 5 Satelite 3 
ASTS 3 ASIS 3 
TEXT tee ree + 
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Input: 
\asis 
SOME SP ceeverecan acd 
ASIS $ ASIS i 
TEXT tem + 
\block 


4e.2 BLOCK MODE 
V\BLOCKs JInnsInnsHnn 


Block mode forms paragraphs from “text  R8LOCKs™ passed to 
it. Note that a text biock of one character Is permissibie. 


A “text block™ is a set of one or more tines: of data which 
is started by a tine of text with a blank in column ones = =§ and 
ended by either the next line with a blank in cofumn one or by 
a command which ptaces text in the outout at that point. 


Each text block is started on a new line and is normally 
right justified between the left and riaqht marginse A blank 
fine produces a biank tine. A series of fines which start 
with a blank in column one would appear as a fist at the left 
margin. 


If the data for a text block starts in cotfumn twos the 
generated paragraph will begin at the left margin. But IF x 
additional blanks are left after the text block start btank»s 
the whole text biock will be indented by x positions from the 
feft margin. 


If the PARAgraph feature is ons the first line ‘in aietext 
biock wilt be indented by three spacas fron the margine See 
the PARA command, 


J specifies the number of tines (nn) to JUMP at the 
beginning of each text block. This is in addition to 
any lines skipped by explicit TXTCODE commands. The 
default is JO. 


I INDENTs the first fine of the text block nan positions 
from the margin. The defauit is 15. 
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H HANGs (indents) the second and succeeding tines of the 
block text nn positions from the nargins The default is 
HO. 


Examples 


This formats which is a BLOCK mode oaragqraphs is generated 
by the input shown below under Input. 


Indentation tike this is accomptished with additional 


blanks on the first tine of the text block. The PARAgraph 
feature is on throughout. 


Input: 


This formats which is a BLOCK mode paragranhs is 
generated by the input shown betfow under Inout. 


Indentation tike this is accomplished with 


additional bianks on the first tine of the text 
block. The PARAgraph feature is on throughout. 


403 COMMENT MODE 
\COMMENT 

Comment mode ignores afi non-conmmand tines. Note that 
commands are stilt processeds including text on the command 
line. This is in contrast to \STOP which ftgnores everything 
until a subsequent \GO is received. Connent is not intended 


to be used to “turn-off" sections of the input file - use 
STOP /GO. 


4e4 ELOWIAB MODE 
ANFLOWTABxttstts..-.ttsff ege \FLOWTAB$S1520 


This mode allows text which is to "Flow" between aoeteft 
start position and the right margin to start on the same tine 
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as text which has been tabbed into position. 


The first character x after the commands if non-blanks 
resets the tab character to the given character. The tab 
Positions follow. (Defaults are 31520.) The Last position 
given specifies the start position for the flowing text. Note 
that text may be tabbed feft and right of the text which is to 
flow between the given start position and the right margin. 
When tabbing to the rights it is usually necessary to first 
adjust the right margin using the \LENGTH=nn command. The 
original right margin may be restored by using the \LENGTH 
command. 


Data is entered in the order of the tabbing sequence used 
in the command. Tabbing is relative to the teft margins so 
that a tab set to 1 will cause the associated text to start 
immediately to the right of the left margin... 


Each fine starting with a blank forces’ a new line. An ali 
blank line leaves» as usuals a blank fine in the output. 


A text block which starts with a blank but which does not 
have the tab character specified nextys is assumed to be 
Ffilowning text and is placed at the tast position specified in 
the command. <Any x additionai blanks after the first ones 
cause the text biock as a whole to he tndented x positions 
from the beginning of the flowing text. 


NOTE: Gncee the flowing text is reacheds the tab character 
may be used freeiy in the flowing text. 


See the SETH command if a "hard blank™ (ie. 
non—-compressible) character would be useful itn positioning the 
tabbed information. 

The following shows how to set up sone FLOWTAB type text: 


Examples 
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COMMAND PARAMETERS ACTION 
ADD YES Add the given fPiles: to the tape 


library and put the comment 
information on the tast file 
given. 


DAYFILE NO Leave dayfilte for batch job on a 
permanent file when done. 


This starts at the flowing text 
position; the tab character may 
be used nornally here, 


This ts: {indented by four 
positions thr oughout the 
paragraoh,. 
Input: (\SETU specified at start of document) 
\keepl7 
\FLOWTAB5$1s15,5 30 
3“COMMAND™ 3;”PARAMETERS™ 3” ACTION” 


3ADD ;YES j;Add the given files to the tave library 
and put the comment information on the Yast file given. 


;DAYFILESNOD s$Leave dayfiie for batch Iob on a 
permanent file when done. 


This starts at the flowing text position; the tab character 
may be used normality here, 


This is indented by four positions throughout 


the paragraphe 
\block 


45 JTEM_ MODE 
VNITEMs Inns Inns SnnsGnnsHnnsZxxsC=es0 ege NITEM 

Item mode allows the user to generate a property indented 
and aligned jist of items where each iten Is normally preceded 


by some character string such as? ~~» ¥*» «o» ley €a)» Aes or 1) 
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etce The above exampiess plus any prefix character string» 
are handled gutomatically unless ITEM node is called with its 
own settings. ITEM mode will set up default values for ail 
parameters that are not supplied on the conmand,: 


Notice that the default value of one Parameter can be 
automatically altered by specifying another parameter. EeGs 
giving G4 alters the defauit value of 4. 


{(Preceeding the input data for the following six paragraphs 
with the command "\ITEM™ would format that text as it appears 
below). 


J specifies the number of tines (nn) to JUMP at the 
beginning of each new item. This is in addition to any 
fines skipped by explicit TXTCINE or TXTFORM commands. 
The default is J0. 


I indicates the prefix characters are to be INDENTed from 
the margin by an amount nne The default vaiue for I 
depends upon the resulting value For $3. see the table 
below. 


S$ specifies the SIZE of the prefix string as nne (nn may 
be greater than 3). The first actual item encountered 
wii) set the SIZE for the prefix string areas unless the 
S parameter is given on the ITEM command. Subsequent 
prefix strings will tfteft adjust in the orefix string 
field if shorter than the first prefix strings while 
longer prefix strings wit! be right adjusted in the 
prefix string field. By specifically giving a targe or 
smaift S values the prefix string information can be 
forced to be left or right justified within its field. 


G gives the GAP after the prefix strings; nn columns. The 
defautt value for G is determined fron the table below 
using the resulting value for S. 


H HANGS the text which overflows tine one under the first 
non-blank character following the prefix string or as 
requested. The default value for HY is equal to I+5$+G. 


ZsCsQ These are the parameters controltting automatic item 
label generation. A full description of these 
parameters is given in the section on Automatic Label 
Generation of Itemized Lists which follows shortly. 


The following diagram shows the neanings of the various 
terms used: 


60460280 01 


4-7 
COC — SOFTWARE ENGINEERING SERVICES 
13 DEC 83 
TXTCODE 2.0 Reference Manual REV: 1 
4.0 DESCRIPTION OF MODES 
425 ITEM MODE 


SAE OS A SAY ED AE A D GN “AED EN OY ED TN ED ND RO GD AD AS AES EEN ED SE SN AE NS ES SE NOE 0D AD ND OED A AS ED ND AD AD ASS EE ES ND SEED AED A AED OTS VRS RT ED AE WA NEI AD AD CNN AONE ND NO OE 


t-—- Hang Amount (eeg. 6 spaces) 
t--- Indentation (e.g. 3 soaces) 
2 t=~~ Prefix String (@.9.) 2? characters) 
3; $ +<-—— Gap (eege 1 space) 
+ &§ &§ #-—— Text Body 
Vevyv Vv 
ww te XXKXX XXXweoeXXX 
=-> XXX XX. 


>} 66 we ae ww oe we 


Blank lines produce blank lines on outout. Each tine which 
starts with a blank forces a new tine to be started. 


The prefix string ends at the second btank character in the 
line. Hences if positions one and two are biank a null prefix 
string is assumed and text starting in column three would be 
aligned with the text body of the previous item. 


Any x additional obfanks in cotumns 3243005 cause the 
following text inciuding overflow portions to be indented from 
the text body of the previous item by x positions throughout. 


Finallys text which starts in position one of the tine and 
which follows a blank fines will be treated as a non-item and 
aligned at the left margin. 


The following tabie shows how ITEM will sat uo its Is Ss G 
and H values for various sizes of prefix strings when the 
first item is encountered: 


SIZE ion ann Gnn Hon (14+S+G) 
1 3 1 2 5 

2 3 2 ri 5 

3 2 3 1 h 

4 1 4 1 6 

5+ 0 5+ 2 7+ 


iten Parameter Defaults Table 
Examples 


The input shown below would produce the format shown aboves 
where the Js I» Ss Gs Hs Zs Cs» and O parameters are explained: 
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\Nitem 

J specifies the number of lines (nn) to JUM? at the beginning 
of each new item. This is in addition to any lines skipped 

by explicit TXTCODE or TXTFORM commands. The defauit is JO. 


I indicates the prefix characters are to be INDENTed from the 
margin by an amount nnw The default value for I depends upon 
the resulting value for S3 see the tabte betow. 


S specifies the SIZE of the prefix string as anne (nn may be 
greater than 3). The first actual iten encountered will set 
the SIZE for the prefix string areas uniess the S$ parameter 
is given on the ITEM command. Subsequent prafix strings wilt 
left adjust in the prefix string field if shorter than the 
first prefix strings white longer prefix strings will be 
right adjusted in the prefix string fieid. 8vy specifically 
giving a large or small S$ values the prefix string 
information can be forced to be left or riaht justified 
within its field. 


G gives the GAP after the prefix string; nan columns. The 
default value for G is determined from the table below using 
the resultting value for 5S. 


H HANGS the text which overflows tine one under the First 
non—blank character following the prefix string or as 
requested. The default value for H is equal to T+#S+G. 

ZsC 20 These are the parameters controlling automatic item 
label generation. A full description of these parameters is 
given in the section on Automatic Label Generation of 


Itemized Lists which follows shortly. 
\block 


Automatic. Labe! Generation on Itemized Lists 


The following parameters exist on the item command to 
implement the automatic labelling of items: 


gZUxeeX)Caer-allzlbeebliclld.~edjj »sCze 99 


Each of the parameters are optional and have the folifowing 
meaning: 


Z = L or 1 =— auto tabel with letters: As Be Coee' Or as Dep Cree 
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Nor n — auto label with numbers: ls 29 3a, 
R or r ~- auto ftabel with roman? I» TX>s IIs IVse. oF 
is Pts Tiiys iVeee 


In the absence of the x..x portion of the conmands the case 
of the "Z" determines the case of the generated iabeils. 
Otherwises xeex is used to specify both a non=-default starting 
value and the case» 


Meex a starting vaiue for tabellings if it is present and is 
compatible with "Z"!s type. Otherwise it is treated as 
A2e28 text. 


A@eea suffix text to follow each generated tabel when no "=" 
option is used in the parameter. 


“2 used for more complex types of auto generated tabel text 
where beeb text is to be specified. 


beeb text which is to precede the auto generated string. It 
might be a *"(" for an (ads (b) type sequence. 


c a point of substitution single character for the auto 
generated sequencess, which is *." by default. It may 
be redefined using the “sCe#e™" oarameters where *"*C*® 
stands for "character™ and "e" Is the new editing 
substitution character to assume both in the command and 
in the following text data prefix strings.’ 


Geed suffix text to follow each auto generated string. tt 
might be a ™)." such as for an CA)De» (B)e» type 
sequence. 


Cze e is a singie character which is to define the point of 
substitution position for the auto generated stringse 
This is for both the command itself and the text data 
which foltows the command. 


+f Override parameter. When this parameter is specified on 
the commands the point of substitution character is not 
sought for in the prefix string ragion of the text data. 
Any non-null character string for a prefix region is 
completely removed and replaced with the auto generated 
sequences It may or may not contain the actual 
substitution character. 
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Eunctioning 
The basic process that occurs is as follows? 
The label types starting values and case is determined from 


the ™Z" and any Xeexe This material is the auto generated 
string and will be incremented for each substitution that 


OCcCUTrSs If there is any aeea materials it is used to set up 
the area that suppties the suffix for each auto generated 
strings If there is an "=z" =<jn the command parameters 


everything following the "=" (until the end of the parameter - 
," or “ *® reached) until the point of substitution is founds 
becomes a prefix to the auto generated string. 


When the substitution character Is Founds any text 
following this character until the end of the parameter is 
used to set up the suffix area material for the auto generated 
string. 


At this point the command has been processed and the 
prefix,» auto generated start strings and the suffix have been 
set up. These three regions as a whotes packed togethers 
become the “item substitution text". This texts of courses 
changes each time it is used since it is being incremented for 
each us@e 


Text_Data Substitution 


Nows each time a non-null! prefix string is encountered in 
the text datas the prefix string is scanned for the point of 
substitution character (usually me)» and the item 
substitution text is used to replace the vooint of substitution 
charactere At this points the text data orefix string has 
been constructeds and it is now treated according to the 
settings of the parameters I» Ss G and Hs whether set 
specificaliy or by the item command. 


So» it ts possible to specify standard oreceding and 
following material for the auto generated strings such as 
parenthesess but still specify special text for a particular 
item that is unique to that item — an "*" for axamptes for a 
footnote. [.ee 


{ade XxXX*X 


({c). 2222 
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4.5 ITEM MODE 
TO OO: le Ae (a) ie Ae 
2e Be {b) Ti. *Be 
| 3 Ce tc) iii. Ce 
ISSUE: 
itemsn. itemsl. itemsi={.) itemsr. itemsLl. 
ms ig “~ i rae sie Ope ere m i as Co ei ewe 


The "*" js used to represent a blank character. 


426 TABLE MODE 
\TABLExttstts..-tt \TABLE3109 209 30006 


As the name imptiess TABLE mode is for use in canstructing 
tables or columns of tabbed information. 


Uniess redefineds the tab character x is "3" and the tabs 
are set to 10» 20» 305 40» etc. If the tab character is not 
to be redefineds leave the position imnediatelty after the mode 
name blanke The tabs are relative to the margin so that a tab 
set to 1 places text in the position right after the left 
margins 

Whenever a data tine begins with a blank characters a new 
fine is forced and the tabbing pointer is reset to tab number 
1. (Data for a singtie tine in a table nay be input on several 
fines.) There are a maximum of 15 tabbing positions 
available. 


An alftt biank fine produces a blank !ine on output. 
PARA and JUST are not applicable to this: node. 
See the SETHx command if a "hard blank" (i.e. 


non=-compressible) blank character would helo in Formatting the 
table. 


Example: (\SETU specified at start of document.) 
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PE AD RN TN NED ND TD A EE NN eRe “HD AD WANS SOND <P ANN ET OD Aaege ANY AERTS MANN AES A “eee A EN UO NE EN OE ND AAD HNN alin NNN DUN A AONE = A ED DD ND OD SED AOD EE WEE AD OD a AE Ue ee A a ee ee 


2iZeé inn 2nn Gon Ynn (1+S+6) 
1 3 1 2 5 
2 3 2 1 6 
3 2 3 1 5 
4 1 4 1 4 
5+ 0 5+ 2 7+ 
Input: 
\keep7 


N\tables 7917s 26335344 | 
s“SIZE~ 37” Inn™ 37%San” 37%Gnn” 3“Hnn”™ (14546) 


\tabile58518s27s36s45 
31 33 31 32 36 
32 33 32 31 36 
33 32 33 31 36 
34 31 34 31 36 
35+30 354+352 37+ 
\bflock 
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500 MODE NESTING COMMANDS 


This section describes the mode nesting facility of 
TXTCODE. 


For example: 


\+ITEM 
1.» Level one in the nest. 


\+ITEMs, IO 
(a) Level two in the nest. 


\=~ 
22 Level one in the nest again. 
ce 


The above example tooks tike this whan formatted: 


1. Level one in the nest. 
{a) Level two in the nest. 
2e Level one in the nest agains 


Mode nesting is a facility which allows an active mode to 
be temporarily interrupted so that another sty!e of text may 
be oprocesseds before returning to the interruoted mode and 
carrying on as though it had not been disturbed. The second 
mode can aiso be interrupted itself and so one In additions 
there is normally an automatic margin shift which causes the 
interrupting mode to be indented under the Interrupted mode so 
that it aligns with the visual margin of the interrupted mode. 


This provides a simple and powerful way of formatting 
compitex text structures. 


\tmode \*mode \-mode 


Nesting is entered by the first occurrence of "\4+mode™ ands 
until the next "\mode"™ commands which siaqnals the exits mode 
commands of the form “"\Vteee™s “Veo o™ and "V\-2e0." control 
movement within the nest. Exit is also acconolished when a 
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VEXITNEST command is given or when a "\=mode" command causes 
the nest to decrease to the zero tevel.e ("\=" may also do 
this.) 


The nest has a maximum number of active ‘parentheses! of 
10. Nesting beyond this maximum level is orocessed using the 
ASIS modes Dropping back below the upoer limit causes the 
specified modes at each level to resume. 


The mode to use for processing data at each tievel in the 
nest is set by the mode given on the mode command that most 
recently set a mode for that tIlevel. Each of "\+mode"™, 
"\smode™ and "\-mode" set the mode at the Tavel that they are 
causing a shift to in the nest. It is possible to move to a 
new fevel in the nest without specifying a modes by giving 
*y4", MVS" or "\-" with no mode. In this cases the mode most 
recently given for that tevel is used. Any level which never 
had an initial mode specifieds uses the ASSIS mode as a 
default. 


Multiple tevels may be shifteds if desireds by. giving 
"WA+teee”" of "leo ee" with or without a node name, 


Moving to a lower ftevel in the nest does not wipe out the 
modes specified for higher nest fevels. Even exiting from the 
nest as a whole wilt not cause the nest mode data to be 
destroyed. It wild remain until it is overwritten by a new 
mode at the appropriate level or until a "\CLEARNEST™® command 
is given. 


This allows the user to take advantage of rapetitive data 
structures to simplify the mode calling orocess and also help 
ensure consistency of formats. Note that for ITEM mode 
especially» even the last used automatically generated prefix 
string is remembered and resumed when the correct tevel is 
again reached. 


ANESTIND 


Another facility is provided when automatic tndentation is 
on during nesting. This facility is on by defauit and “is 
controtted using \NESTIND (nest indent) or \NINESTIND at any 
focation in the document. With nest indent Ns whenever a 
M\+e00" command is founds TXTCODE will cause the new mode to 
be right shifted to the "visual" margin of the orevious mode. 
Actuallys onty the FLOWTAB and ITEM modes have visual margins 
which are usually shifted from the relative margin position. 
(BLOCK mode may aiso have a shift if the Hnn parameter is 
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AE CD CE A ND A A A IE A EE A AN ES ED AED ND AD ND AS A A AOD SS ED A A EE A AS ED a AN A A A A ED OD ED ND A EN A ED A EN ER -O -CE  D 


usede) It is the retfative margin that is being moved to the 
position of the "visual" margin of the ovravious node. 


When coming back out of the nests thea nest indent indicator 
is ignored. Shifting back is done if shifting forward was 
done at this level. 


Level Shifting 


The following is an example of sone nested modes with an 
explanation of what is happening: 


\block 
\+item 
\+FLOWTAB 


\=- 


Initiattys BLOCK mode is activee Then a nest is entered 
with the ITEM mode request. Then sone FLOWTAB material is 
given under several particuiar items - al! with the same 
FLOWTAB formats. After the last FLOWTA3 section is some ASIS 
text which should have the same margin as the FLOWTAB mode had 
when it was called. Then ITEM mode is ovicked up and finished 
and finally the original mode {block) is resumed»s which was 
active before the nest was entered. 


"A\*mode" replaces the current mode at a particular tlevel 
with anew modee The new mode is not indented because it is 
at the same ievel as the one already there. 


Restored Modes 


It should be noted that when a mode is restoreds it is the 
mode that is restored and not all the associated conditions 
that may have been active during that node. 


Ali such features remain under the users direct control 
alone. For examples if a trigger character for underlining 
had been set but was later cleareds reentering the mode during 
nesting would not reestablish the undertining trigger 
character. 
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In additions margin control is aiso stit’ under the user'’s 
direct control. The changes in the relative nargin are made 
during the shifting process in going from one mode to another 
in the nest (when nest indent is active) in: order to fashion 
the indentation structures but the user nay give extra margin 
adjustments of his owns He should be careful to move the 
margin back when the structure is completeds and before he 


changes. levels preferably. Otherwise, arbitrary margin 
changes will fracture the nest structure as a whole at that 
point. 


Visual Margin 


The visual margin is defined as the retative margin for 
ASTS»s COMMENT and TABLE modes. For FLIWTAB nodes» the visual 
margin is where the flowing text starts. For ITEM or BLOCK 
modes the visual margin is where the body of the text falls 
when line overfiow occurs. {Note that the default visual 
margin for BLOCK mode is the normal margin.) 


Mode Switching 
To go into the nest another tevel give:. 

\t+mode 
To change modes at the same ftevel give: 

\*¥mode 
To drop out of the nest one tevel give? 

\-mode 

These three commandss containing the "4+", "*" gor =" jn 

front of the modes control the movenent within the nest» 
entrance into a nest (first "\teee™)» and exit from the nest 
(a "\~-*" at fevel one). <Any mode conmand without the plus» 


asterisk or dash is a regular non-nest node command and will 
terminate a nest if one is active. 


Exoilanation 


Each time a deeper mode is entereds the visual margin value 
is saved for the previous mode ~- that [ss the anount to shift 
the relative margin by ts saved» if nest indentation is 
active. Next the retative margin value is adjusted if 
necessar ye Then the new mode is set up and the actual mode 
data is processed. 
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Nest Clearing 


The entire mode nest may be cleared by using the \CLEARNEST 
(when outside a nest) or VEXITNESTsC commands. This destroys 
ali memory of modes which have been defined in the nest 
structure. 


AEXTINEST2€ 


This command causes an immediate exit from any tevel of a 
nest. The most recent \mode command governs the active mode 
on exit. If the "C™ parameter is specifieds the whole nest is 
completely cleared of mode information. 


ACLEARNEST 


The CLEARNEST command clears ali nest tevels beyond the 
current level. If nesting is inactives it clears the whole 
nest - levels 1 to 103 if nesting is actives it: ctears tevels 
n+l through tevel 10. The current and tower fevelis are not 
affected and nesting is not disturbed. 
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6.0 DESCRIPTION OF _ COMMANDS 
661 DESIGNATION TEXT COMMANDS 


These commands apply to the title block (top of page title 
information)» folio tine (page footing information)» and any 
supplemental lists generated such as a tabie of contents. 
(See \TABLCON command). 


AILTILE 
VTITLEn= xxxx 0 0X or ATITLE 2a Kx m0 0 eX: 


The xKxxxeeex is the information which is tn appear in the 
title position n (n=192.22+6) of subsequent pages. Up to six 
titie fines may be in effect. Unused titie lines will be 
squeezed out of the titie block. The default titie line is 
N=1l, which appears between the page rumber and date lines. 
Other titie fines follow the date titie line. 


ADATE 
\DATE=xxxKxeoe eX 

The current date {in YY/MM/DD format) will be replaced by 
KXXKeeexX at the upper right hand position of subsequent pages» 


It will appear on the current page toos if no text other than 
page header text has been given yet. Eege N\DATEZ13 JUL 79 


\EOLIO 
\FOLIG=xxxx0eoeX 


At the bottom of the page on the folio fines xxxxeeex will 
appear right justified on the current and following pages. 


ATABLCON 


If a table of contents is desireds this command should be 
issued once at the start of the input fite. It should be 
given before any section numbers {(\ MeNeweM XXXKKee eX) are 
given. 


JAUTOSEC and ANQAUTOSEC 


AUTOSEC turns on automatic section nunberinge The level 
number is given by n on a section number conmand line. Any 
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6e1 DESIGNATION TEXT COMMANDS 


NeNeoeesn forms have their level calculated from the NeneeeNes 
That is» ne0 is tevel 13 nen is tevel 23 nene»n is fievel 33 
etce The first level 1 becomes 1.03 tha second tevel 1 
becomes 220 etces while the first level 2 becomes 1.1 and so 
ONnNe 


Automatic section causes page numbers: to change to the n-n 
format; it also causes a section header box to appear at the 
top of each pagee See Section Numbers for additional detail. 


602 BODY TEXT COMMANDS 


These commands control the text which fs in the middle of 
the page ~- between the titie block infor’nation and the folio 
line. 


60201 SECTION NUMBERS 


NV MeNeeel KXXXKe0e X or VM xx ee oX or \N XX¥Keee X 


This command establishes a section number and title data in 
the text and in the table of contents. (See the \TABLCON 
command for generating a table of contents). Normally the 
first format is used with V\NOAUTOSEC and the second form with 
NAUTOSEC. However, the first format can be used by V\AUTOSEC 
and the second format will produce tities with no section 
numbers if used with \NOAUTOSEC. 


Paging (ne0 fevels)>s spacings undertinings and 
capitalization are produced automatically and are governed by 
the tlevel being processed. Standard TXTFORM format § “for 
section numbering is used. See the Heading tLevel Selection 
Table. 


Note: the space after the back slant (\) and also after the 
section number. One space is sufficient. 


In the second forms n is a level number from 1 to 7s or 11 
to 17- {See \AUTOSEC) 
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In the third forms no section number apoears and the text 
is underlined.» It is equivalent to \ 14 xxxe.eexs (Note: the 
third format should not be used if the first word contains any 
periods "."3; use format 2 with n214. The same applies if the 
first part of the title text is numeric.) 


NB: Individual section number fines which are too long may be 
omitted from a tabie of contents by TXTFORM,: 
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HEADING LEVEL _ SELECTION TABLE 
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TXTCQODE 2.0 Reference Manual 
G6e2e1 SECTION NUMBERS 
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H ; 3 > LINES = LINES } H 
H + NEW $$ ALL § SPACED? SPACED? UNDER $ 
; + PAGE $ CAPS $ BEFORE? AFTER ¢ LINED i 
ee ee ae ae ae ee ee ae ef ee ee ef en fee ee} ee ee ee} See ee + 
+H50H15) SECTION 3} ; H H 

1\ 5 xxXKe oeX H H : 

1\ 15 xxKxK cook H ; H 

TN NeNeMeNeN KXXXa0eX H ; 

+; LEVEL 5 H H H 

e VHEADA x ; 1 : 

H \HEADB 3 X H 1 H X 

; \HEADC 3; x ; 1 H X 


2H6TH16) SECTION 3. 


ee ey. a ee ee ee er ee ee 
wt oh me ee Oe ee a eh ee we 


iN & XKXXe0eX H 

:\ 16 xxx ee eX H 

S\N MNeNeNoeNeMeN KXKXeeeX 

+; LEVEL 6 H 

: \HEADA 3 1 X 
; NHEADB 3 X 
He NHEADC , 


fp oe Oe 6H He we ne OW He fh 868 we Se we Oe oe He Oe 


foe ee Se ee eee we we fo we ww we fe er ewe 
tH7(H17) SECTION ; 
3\ 7 KKKe eX H 
2N 17 XK ee eX ; 
SN Nee NMeNeNeNeN KXKeeeX 
>; LEVEL 7NHEADC ; 1 : X 


ee ee ee ee ee ee ee eT) 
oe 66 oh Oe Om oe ee ee ee oe A ee 


ow 68 be oe ae 


oe we we ae oe 


If AUTOSEC is off (default)s the First form shown 
(\ mM xxKKee) is converted to the second form shown 
(N In xxxee) and treated accordingly. 


If AUTOSEC is ons (NAUTOSEC issued)» vage nunbering changes 
from the simple sequential format to the n-n formate Alsos a 
4 fine header box will be produced on each page which will 
contain the currently active major section (nO Ievel) and the 
currently active heading fevel being orocesseds of whatever 
level. AUTOSEC doesn't produce numnbertng for (VN In xxxee) 
type headers» but it does replace any MNeteeeh fFormss which 
effectively allows renumbering of old section numbers. 


NOTE: that AUTOSEC effects do not occur until the first 
header command tine (\ n xxxeeex}) has been encountered. 


Also note that the form (N xxxeeex)d is treated as the 
following form in ail casess (\ 14 xxxeoeX)>s 
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6e2e2 FEATURE SELECTION/DE-SELECTION 
APARA 
\PARA VPARAnn \NOPARA 


With the PARAgraph feature selecteds BLOCK mode paragraphs 
which begin at the left margin have their first tine indented 
by the number of spaces specified for the \PARAnn command = or 
by three spaces for the \PARA command. 


AUNDER_ and \NOUNDER 


Specifying UNDERJining will cause thea following lines of 
text to be underlined until a NOUNDER!Tine command is given or 
until the mode is changed or a section number is encountered. 
This command is oriented toward underlining for which it is 
not convenient to use a trigger character for control. {See 
the SETUx command). 


JUST. and \NOJUST 


Right JUSTification occurs as a default. Text which is 
being built up so that it overflows to the next fine when the 
right margin is met is normally aligned with the right margin 
by adding extra spaces between words. This feature has no 
effects even if selecteds if it Is not apvropriate to the 
currently active mode. TABLE and ASIS mode ignore this 
feature. Note that JUSTification onty alftows backing up in 
the tine for 30 characters. Therefores if a blanks -»s or / is 
not founds, a 'LINE OVERFLOW! message will be issued since a 
place could not be found to break for JJISTification. 


\BOLO. and_ANQBOLD 


The BOLDface command instructs the formatter’ to print each 
character which follows in such a way that the characters 
appear darker and thicker. BOLDFacing stops when the 
NOBOLOfacing command is given or when the mode is changed or 
when a section number is encountered. The command is oriented 
towards BOLDfacing text for which a trigger character in the 
text itself is not appropriate. (See the SET8x command). 


ASEQ_and_ANQSES 


If it is desired to have each outout line in the document 
followed by the number of the fines issuing the SEQ command 
wit initiate this processe {(Defauft Is NOSEQuencing). 
SEQuencing numbers will appear right justified on the fifth 
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character position to the right of the right margin or the 
fength as established by the TXTFORM "FIRMAT”™ command (default 
is 75)s whichever is greater - absolute colunn 80 by default. 
S€Quence numbers start at 1 on each new oage and appear only 
beside text in the body of the documents The feature may be 
turned on or off at any point in the docunent. 


NOTE: The TXTFGRM FORMAT command is used to give the margin 
values for heading and folio lines and to soecify the totai 
page depth. It may only be given once and must be before any 
text is input. Using the direct TXTFORY command capability, 
it may be specified as follows: 


\N\FORMATaasbbsenn 


where aa is the left margin (default is 7)» bb is the absolute 
line length (default is 75)» and nn is the total page depth 
(default is 60). These margin vaiues do not apoty to the main 
body of the text. 


\KEEPon_and_\NOKEEP 


Sometimes material on different lines must be kept on the 
Same page to be readable. To make sure that the next nan iines 
of output appear on the same page specify KEEPnn. NOKEEP 
serves only to mark the end of the keot text and fs not 
actually necessary. 


AS INGLE and \DQUBLE 


It is often desirable to altow different standard tine 
spacing on documents. For examples double spacing is quite 
useful for draft documents to which many changes are usually 
made@e SINGLE and ODOQUBLE select single and double spacing 
respectively for the formatted output text. 


AHEADA2 AHEADB2 and \HEADC 
These commands affow selection of the TXTFORM heading 
styles As Bs and C respectively. See the heading tevel 


selection table for a description of the effect of the 
different heading styfes. 


ACQDES 


This is used to produce 2 TXTFORM command statistics and 
error summary tist at the end of the formatted document. 
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6e2e2 FEATURE SELECTIGN/DE-SELECTION 


AMARK 


The MARK command is used to set a maraqin note in the tine 
being formatted. An asterisk (*) is inserted at the current 
position in the tine and a pointer (<) is placed in the right 
margin. 


60223 TEXT FORMAT CONTROL COMMANDS 
AMARGIN: 
\MARGINAN AMARGIN \MARGINGeNY \MARGIN-nn 


This command determines where text should normally start at 
the left hand side of the page» MARGINAN redefines the BASE 
MARGIN (default is 10) to the new value nn. Normatty 
adjustments are made to the margin by sdecifying the change 
relative to the old margin Instead of soecifyina the absolute 
margin each time.» The #nn and -nn forn is used to accomplish 
this. Note that a \MARGIN¢2 followed by \MARGIN#3 command is 
equivalent to a \MARGIN#+5 command. 


At any times the BASE MARGINs the one defined by the tast 
MARGINnan commands oor MARGINIO by defaults may be returned to 
by asking for MARGIN with no value. In this: way the margin 
may be temporarily redefined and then returned to the old 
value without remembering that value. 


The ABSOLUTE margin is the extreme Ile®fthand side of the 
page; the BASE margin is at 10 unless redefined using 
\MARGINnn$ and the RELATIVE margin is initiatly equal to the 
BASE margine The RELATIVE margin is noved by \MARGINenn and 
\MARGIN=-nn commands as wet! as by mode nesting commands = and 
may be reset to the BASE margin by \MARSIN, 


\LENGTH 
\LENGTHnn \LENGTH \LENGTH#tn4 \LENGTH=nn 


This command specifies the LENGTH of the text line as 
measured from the BASE MARGIN (see above). The default vatue 
is 62. Hences an ASSIS tine of up to 62 characters can be 
placed on each output tine using the default value, 
(\MARGIN=-nn and \MARGINéenn will jengthen or shorten” the 
effective line fength.) Adjustments may be nade relative to 
the old tength in a similar manner to the MARGIN command 
above. 
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ASKIP 
\SKIPnn 


To write nn blank lines to output at any times use _ the 
SKIPnn command. The nn defauits to 1. Note that if paging 
occurs in the process» the command does not teave the rest of 
the biank tines at the top of the naxt pagee If an actual! 
amount of blank paper is desireds say 2 inchess issue a KEEPI12 
(2 inches times 6 lines per inch = 12 lines) then a SKIP12. 


APAGE 
\NPAGE or \PAGENnn 


At any times a PAGE eject may be forced using this command. 
Two consecutive page ejects do nots, howevers tfteave ai blank 
pagee (Entering the command BLANK between the two PAGE ejects 
wili)d. If it is desired to cause the next PAGE number to be 
reset to a vatue nnns include the value Immediately after the 
command. 


\BLANK 
\BLANK or \BLANKnn 


If this command is givens nnn blanks (default is 1) will be 
inserted in the text stream at the current position. See the 
SETHx command for generating “hard blanks" using a speciaity 
designated character instead of the 8LANK command. 


\CENTER 
\CENTER= xxxXx 00 0X or \CENTERs3s9U=xxxeeeX 


The xxxxeeex text will be CENTERed on a new tine between 
the left and right margins. Consecutive embedded blanks are 
compressed to one blank. B and J oarameters are “for 
boldfacing and underlining XXKeeeXe Svecial trigger 
characters in the xxxxeeex text will be recognized and 
processeds if sets If the first form of the command is used. 
See the SETUs SETB and SETH commands. 
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60204 APPENDICES 


ASET APP 
\SETAPP=a-xx xe o0X 


This command is used to define apoandix text, The 
character value of “™a™ defines the anvoendix identifier and 
"xxxeeeX" is the appendix tittie. This infornation appears in 
the table of contents (see the TABLCIN command) and the user 
should set up his own appendix title page as destred as well 
as the body of the appendix text. 


The appendix identifier "a" precedes both the section 
number and the page number wherever they apvoeare One method 
of setting up an appendix follows: 


NSETSEC] - resets section nunbers to 1 
\SETAPP=A-APPENDIX A - sets appendix character and title 
\PAGE1 ~ sets up tittie oage as page l 
\BLANK 

\SKIP20 


\CENTER»s B=* Appendix A * 


VCENTER=Speciai Conditions 
\PAGE - starts body of appendix text 
\ 1 Introduction 


® 


6.225 30X GENERATION COMMANDS 


The following commands are used to draw boxes but the 
vertical spacing in boxes is controfled by commands or text 
given while a box is active. Usually TA3LE or FLOWTAB mode is 
used to supply the text for a boxe 


ABOX 
\BOX or \BOXsf—InnsAsnns Bsl—Inn»sRsl—Inn 
The BOX command is used to initiate the drawing of vertical 
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fines which are all joined together by a horizontal tine at 
the top. For examples the command \B0X%s10229539 would be used 
to start the following box: 


a 2 J 
2 a 3 
2 a 
s 4 
ee ae ee tn oe 2 oe ee oe te eee ee ee eee om +> 
2 3 
s % 


The two outside columns are at columns 10 and 30 with 
respect to the relative margins white the center tine 
(vertically) is at column 20. By defaults, the column 
positions are with respect to the retative nargin. At any 
point in the commands the reference point may be changed to 
the BASE margin with the "B" parameters to the ABSOLUTE margin 
using "A™,»s or back to the RELATIVE xwnargin with the **R*" 
parameter. {See the MARGIN command for an explanation of 
margins.) The As Bs and R parameters nay he used several. 
times in the command if desired. 


For the BASE and RELATIVE marginss it ts possible to 
specify a column position to the left of the margin by 
preceding the column number with a minus sigqn "-", Therefore 
"#—1" and "1" specify vertical tines which are adjacent to each 
other surrounding the margin ("0" is equivatent to "-1"), 


Up to 17 vertical lines may be in effect at once. 


If \BOX is given with no parameterss the settings in effect 
for the previous box are used. 


\MO0 BOX 
\MODBOX»s C[-Inn»s AsnnsBsl—Inn»sRsl—Inn 


This command is used to modify a box in oprogress. The 
parameters are the same as for the BOX comnand. For each 
column givens there are two possible actions. [If that coiumn 
already has a vertical fine being drawns the tine is turned 
off. If it does not have a vertical fine in effects, one is 
started. In additions MODODBOX joins the resuitting outside 
verticals with a horizontal line. The ahove box had “its 
center vertical terminated by the following somnand: 


\MODBOXs20 
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A ANS ana aE OR CD SEE NN AND ED AND TS SA A EN A A EN OD A NDS NN ALAND NE AE Ey AN A OE UTS ane ND SA AED NS SONS SD ES AE A ED ND END ES sg AD EN ED ED AD eae Ne a A 


ABOXLINE 
This command draws a horizontal tine between the inside and 


outside vertical lines of the boxe The third horizontal in 
the box above was drawn this ways 


ANQBOX 


NOBOX is used to end a box currently in effects drawing the 
final horizontal tine terminating the box. 


Exampte: 
pn a anf nr ee fn a nn nn nn nn oo nf 
: OA +} ABSOLUTE ; This parameter causes the fotlowing 
H 2 + values to refer to the ABSOLUTE } 
: ; + margins H 
hm fo a re aw a a no ent 
: 8B +. BASE : This parameter causes the following 3 
: H : values to refer to the BASE margin. $ 
De ne ne ee 
s R s RELATIVE 3 Finallys this parameter causes the 3 
H : +; following values to refer to the 
; ; + RELATIVE margine H 
fa wn fp a ee fe oof 


Input: 


\KEEP12 
\NBOXs~-1s 7221362 
\FLOWTAB$ 39105 24 
VLENGTH-3 
3A ZABSOLUTE $This parameter causes the following values to 
refer to the ABSOLUTE margin. 
\BOXLINE 
3B 3BASE ;This parameter causes the following values to 
refer to the BASE margin. 
\BOXLINE 
3R SRELATIVE sFinallys this parameter causes the following 
values to refer to the RELATIVE margin. 
\NOBOX 
\LENGTH 
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602026 ESCAPE CHARACTER DEFINITION 


ASETEx 


To reSET the master Escape character for commands to 
another character x issue this command. (Default is \) 


ASETUx 


To turn on a trigger character x to cortrol the starting 
and stopping of Undertining give this connand. The feature is 
turned off by giving a blank character for the x. (Default 
condition is no trigger character set)» Also» note that the 
effect of a mode change or the occurrence of a section number 
command will turn off Undertining just as the second 
occurrence of the trigger character would. S8ut the feature 
itself remains set. A suggested character to use for 
triggering undertining is  — or “. 


NOTE: If the underlining and boldfacinga trigger characters 
are set to the same character at the sane tines both functions 
will be controlled by the one trigger character, 


ASETBx 


This feature Is exactly analogous to undertining (see 
above) except that it controls Boldfacing. A suggested 
character to use to trigger this feature on and off is 4. 


ASETHx 


From time to time it is necessary to use special blanks in 
the text called “hard blanks"s which wil! not be compacted 
into one (1) blank or expanded into more than one blanke The 
hard biank is also useful in forcing tabbed data into proper 
atignment if the teft hand side is not straight. The BLANK 
command is not always convenient in such cases. This commands 
SETHxs allows the user to specify a character which is to be 
considered to be a hard blank until the feature Is turned off. 
Each subsequent occurrence of the character forces a single 
biank to be shown in its place. 


A suggested character to use is the circunflex (*) or the 
jeft apostrophe. 
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SS AD ED ND ND NS EE RS AD et ee I EE EE RS EAE AES NE i EE AO OEY A ST AO AN NS STD SNE SO “ENED SONA in en OY ED AD DN ON A NS ME NS ND ND OD GY ED AND A OD EP ED ee See ee AE 


7e0 DIRECT _TXTFORM COMMANDS 


Any TXTFORM command may be given directtiy by prefixing that 
command by two master Escape characters rather than one. The 
preprocessor strips off the first master Escape character and 
passes the command directly to TXTFOR4Y. No command validity 
checking is performed. 


@egGe \VV10»20930 
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